Reference: configProc |
configProc opens up a Windows GUI box to allow the user to configure the filter's settings.
Prototype |
int configProc(FilterActivation *fa, const FilterFunctions *ff, HWND hWnd); Parameters: fa Pointer to filter activation structure ff Pointer to callback function structure hwnd Handle of parent window Return value: Function should return zero if configuration is successful, and non-zero if the user aborted configuration. Exceptions: No exceptions should be thrown from this function. Requirements: Function may be omitted. No default action is taken.
Remarks |
If you do not have a configuration dialog, omit configProc. VirtualDub attempts to open a filter's configuration dialog when a filter is first added, and if configProc returns non-zero, the filter is not added to the chain.
Generally, configProc is implemented as a call to DialogBoxParam() with the given parent window handle. Remember, VirtualDub starts the process, so you will need to use your filter's cached module handle to access dialog box resources.
Any settings exposed here should also be replicated in the filter's scripting interface, so that the filter works properly in batch mode and in Avisynth.
Please make sure your dialog fits in a 640x480 screen -- some video cards with integrated capture do not work unless the desktop resolution is lowered, and so your filter may still be used on a system with a 640x480 or 800x600 desktop.
VirtualDub external filter SDK 1.05 | ©1999-2001 Avery Lee <phaeron@virtualdub.org> |